Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie User Data

NewUserDataFromHandle

The NewUserDataFromHandle function creates a new user data structure from a handle.

pascal OSErr NewUserDataFromHandle (Handle h, 
                                    UserData *theUserData);

h

Contains a handle to the data structure specified in the parameter theUserData.

theUserData

Contains a pointer to a new user data structure.

DESCRIPTION

The handle specified in the h parameter must be in the standard user data storage format (that is, as an atom, just like a public movie). Usually the handle will have been created by calling PutUserDataIntoHandle (described in the previous section).

ERROR CODES

memFullErr

-108

Not enough room in heap zone